請 AI 開發 Block Theme 不只是為了追求最新的技術，而是它的基礎架構對於 AI 來說相對友善，我是實際用 Claude Code 開發過兩種主題之後才體認到這個差距，開發傳統佈景主題時 AI 很容易一股腦的把所有東西往 functions.php 與 style.css 塞，然後每個頁面該長一樣的地方卻不一樣，Block Theme 則是很好的維持 UI 元件的一致性。

AI 對於傳統佈景主題的弱點

語言模型改程式碼時最容易漏掉三件事：隱藏的狀態、跨檔案的依賴、與沒有明確邊界的覆蓋規則，這三件事在傳統佈景主題很容易讓 AI 踩到雷。

改一個按鈕顏色，AI 得先搞懂這顏色是 style.css 定義的、還是被某個 @media 覆蓋、還是某支外掛用 !important 蓋掉的。它得讀懂整條 CSS cascade，還要讀 functions.php 裡有沒有 wp_enqueue_style 動態改了載入順序，改完之後 AI 自己也沒把握會不會波及其他頁面，因為 CSS 的影響範圍，本質上是全站通吃的。

這種「牽一髮動全身、而且看不出髮根在哪」的結構，是 AI 出錯的高風險區，它會給你一個看起來很合理、實際上有很大機率會把東西弄壞卻沒人知道。

Block Theme 的原生架構剛好是 AI 擅長的守備範圍

Block Theme 把同樣的任務變成 AI 最容易理解的架構。改顏色？改 theme.json 裡 settings.color.palette 那一個值，範圍明確無副作用。做一個新區塊？那是一個架構獨立存在的資料夾，有 block.json 宣告介面、有獨立的 render.php 或 save.js，邊界清清楚楚。組一個頁面？那是一串結構化的區塊標記，AI 讀得懂每個 wp: 註解代表什麼。

關鍵差別在這裡：Block Theme 用宣告式、結構化、有明確邊界的設定，取代了傳統主題那種命令式、全域、靠覆蓋順序運作的樣式邏輯，前者正好是 JSON、是 schema、是可預測的局部修改，對於語言模型非常友善。

不只是好改，是好驗證

還有一個容易被忽略的點：Block Theme 的產出好驗證。

傳統主題改完 CSS，你得在瀏覽器裡一頁一頁點過去，確認沒有別的地方被弄壞，因為你無法從程式碼靜態判斷影響範圍。Block Theme 改完 block.json 或 theme.json，改動範圍寫在結構裡，你（或 AI）可以在不開瀏覽器的情況下，就大致推斷這次改動的邊界，這讓 AI 的「自我檢查」變得可行，也讓 code review 快很多。

對 AI 協作來說，好驗證跟好生成一樣重要，一個 AI 能自己確認對錯的任務，比一個要人類逐頁檢查的任務可靠度高太多了。

Block Theme 的限制

但吹了這麼多 Block Theme 的優點，它的硬傷是在學習曲線比傳統主題陡，你得先理解區塊標記、theme.json schema、FSE 那套檔案與資料庫的雙軌機制。對只想「快速改個 CSS」的小需求，傳統主題有時候反而更直接。

但如果你的工作型態是「大量、重複、要跟 AI 協作地開發主題與區塊」，那 Block Theme 的結構化優勢會隨規模放大，這也是為什麼接下來整個第三部，我選擇用 Block Theme 一步步實作，下一篇我們往 Block 的內部走，先從最小的單位開始：一個 RichText、一個區塊，到底是怎麼組成的，並說明跟傳統編輯器差在哪。

文章目錄：https://oberonlai.blog/category/2026-ithome/